home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / mimic.zip / MIMIC.DOC < prev    next >
Text File  |  1992-10-22  |  4KB  |  106 lines
  1.                                 M I M I C
  2.                                + + + + + +
  3.  
  4.                    Version 1.10           Compiled 10/22/92
  5.  
  6.                                    by
  7.                             Michael A. Conley
  8.  
  9.                Another Public Domain Wildcat! SysOp's Utility 
  10.                                   from
  11.                         The Charlatan's Cabin BBS
  12.                              (213) 654-7337
  13.  
  14.          This program requires BRUN40.EXE anywhere in the DOS path.
  15.  
  16.  
  17. WHAT IT DOES:
  18. =============
  19. MIMIC will take an ordinary text file and prepare it for import into
  20. your Wildcat! message database, utilizing the UTIIMPRT program (one of 
  21. the Universal Text Interface drivers which are widely available.)
  22.  
  23. In addition to producing the correctly formatted headers, MIMIC will also
  24. break messages into units of 150 lines, and place a remark at the beginning
  25. of subsequent parts indicating that it's a continuation of the previous
  26. message.  If MIMIC can detect a paragraph break (by locating indented text
  27. or a blank line) within the last 30 lines of a message, it will break the
  28. message at that point, to help make the text more readable.  MIMIC will 
  29. also trim excess-width lines to the UTI maximum of 72 characters.
  30.  
  31. You specify the name of the INPUT file on the DOS command line.  MIMIC will
  32. produce a file named MIMIC.IN which can be processed by UTIIMPRT.
  33.  
  34. SETTING UP:
  35. ===========
  36.  
  37. MIMIC searches your DOS path for MIMIC.CFG, a short configuration file which
  38. tells MIMIC how to address your message:
  39.  
  40. TO=MICHAEL CONLEY
  41. FROM=MIMIC PROGRAM
  42. SUBJECT=Here's a message for you
  43. PVTFLAG=YES
  44. ECHOFLAG=NO
  45.  
  46. The 5 lines above are required to run MIMIC, a program which will import
  47. the text file specified on the DOS command line and produce MIMIC.IN, a
  48. text file formatted for import to your message database via the UTIIMPRT
  49. program (one of the UTI drivers available for Wildcat! and other popular
  50. BBS software packages.)
  51.  
  52. Here's a brief explanation of the lines:
  53.  
  54.      TO=           Place the name of the intended message recipient in
  55.                    this field.  You must limit the length to the number
  56.                    of characters allowed by your BBS software.
  57.  
  58.      FROM=         Place the name of the author of the message in this
  59.                    field.  You must limit the length to the number of
  60.                    characters allowed by your BBS software.
  61.  
  62.      SUBJECT=      Indicate the subject of the message here.  This field
  63.                    will accept upper and lower case.  You must limit the
  64.                    length of this field to the number of characters allowed
  65.                    by your BBS software.
  66.  
  67.      PVTFLAG=      If you'd like this message to be private, put the word
  68.                    YES in this field.  
  69.  
  70.      ECHOFLAG=     If you'd like this message to be echoed to the network,
  71.                    put the word YES in this field.  
  72.  
  73.  
  74. RUNNING THE PROGRAM:
  75. ====================
  76. MIMIC generates a new text file named MIMIC.IN which can be read directly
  77. by the UTI import program.  You'll want to test MIMIC to be sure it can
  78. find its configuration file and also the text file you've specified on
  79. the DOS command line.
  80.  
  81. You may add an optional switch to the MIMIC command line to over-ride the
  82. SUBJECT text in the configuration file.  This might be useful if you wanted
  83. to use MIMIC to produce several messages without creating multiple .CFG
  84. files.  To use the switch, invoke MIMIC with the input filename first, 
  85. then the switch as  /S=Different Subject Text Here
  86.  
  87. MIMIC TROUBLE.RPT /S=Report of System Trouble
  88.  
  89. You'll need to run UTIIMPRT after EACH run of MIMIC, because MIMIC
  90. will always create MIMIC.IN, and will over-write it on subsequent
  91. operations.
  92.  
  93. It's best to run MIMIC from a batch file -- we'll call it MSG.BAT:
  94. (be sure you DON'T name it MIMIC.BAT or you'll confuse DOS).  
  95.  
  96. Here's a sample MSG.BAT:
  97.  
  98. @echo off
  99. REM first remove any outdated copy of MIMIC.IN
  100. if exist mimic.in del mimic.in
  101. MIMIC SYSTEM.RPT
  102. if not exist mimic.in goto done
  103. UTIIMPRT <conf-number> MIMIC.IN
  104. :done
  105.  
  106.